home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds.fmt / tar.man < prev    next >
Encoding:
Text File  |  1989-01-02  |  6.8 KB  |  199 lines
  1.  
  2.  
  3.  
  4. TAR                       User Commands                       TAR
  5.  
  6.  
  7.  
  8. NNAAMMEE
  9.      tar - tape archiver
  10.  
  11. SSYYNNOOPPSSIISS
  12.      ttaarr [ key ] [ name ... ]
  13.  
  14. DDEESSCCRRIIPPTTIIOONN
  15.      _T_a_r saves and restores multiple files on a single file (usu-
  16.      ally a magnetic tape, but it can be any file). _T_a_r's actions
  17.      are controlled by the _k_e_y argument.  The _k_e_y is a string of
  18.      characters containing at most one function letter and possi-
  19.      bly one or more function modifiers.  Other arguments to _t_a_r
  20.      are file or directory names specifying which files to dump
  21.      or restore.  In all cases, appearance of a directory name
  22.      refers to the files and (recursively) subdirectories of that
  23.      directory.
  24.  
  25.      The function portion of the key is specified by one of the
  26.      following letters:
  27.  
  28.      rr       The named files are written on the end of the tape.
  29.              The cc function implies this.
  30.  
  31.      xx       The named files are extracted from the tape.  If the
  32.              named file matches a directory whose contents had
  33.              been written onto the tape, this directory is
  34.              (recursively) extracted.  The owner, modification
  35.              time, and mode are restored (if possible).  If no
  36.              file argument is given, the entire content of the
  37.              tape is extracted.  Note that if multiple entries
  38.              specifying the same file are on the tape, the last
  39.              one overwrites all earlier.
  40.  
  41.      tt       The names of the specified files are listed each
  42.              time they occur on the tape.  If no file argument is
  43.              given, all of the names on the tape are listed.
  44.  
  45.      uu       The named files are added to the tape if either they
  46.              are not already there or have been modified since
  47.              last put on the tape.
  48.  
  49.      cc       Create a new tape; writing begins on the beginning
  50.              of the tape instead of after the last file.  This
  51.              command implies rr.
  52.  
  53.      The following characters may be used in addition to the
  54.      letter which selects the function desired.
  55.  
  56.      oo         On output, tar normally places information speci-
  57.                fying owner and modes of directories in the
  58.                archive.  Former versions of tar, when encounter-
  59.                ing this information will give error message of
  60.  
  61.  
  62.  
  63. Sprite v1.0               May 23, 1988                          1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. TAR                       User Commands                       TAR
  71.  
  72.  
  73.  
  74.                the form
  75.                     "<name>/: cannot create".
  76.                This modifier will suppress the directory informa-
  77.                tion.
  78.  
  79.      pp         This modifier says to restore files to their ori-
  80.                ginal modes, ignoring the present _u_m_a_s_k(2).
  81.                Setuid and sticky information will also be
  82.                restored to the super-user.
  83.  
  84.      00,, ......,, 99 This modifier selects an alternate drive on which
  85.                the tape is mounted.  The default is drive 0 at
  86.                1600 bpi, which is normally /dev/rmt8.
  87.  
  88.      vv         Normally _t_a_r does its work silently.  The vv (ver-
  89.                bose) option makes _t_a_r print the name of each file
  90.                it treats preceded by the function letter.  With
  91.                the tt function, the verbose option gives more
  92.                information about the tape entries than just their
  93.                names.
  94.  
  95.      ww         _T_a_r prints the action to be taken followed by file
  96.                name, then wait for user confirmation. If a word
  97.                beginning with `y' is given, the action is done.
  98.                Any other input means don't do it.
  99.  
  100.      ff         _T_a_r uses the next argument as the name of the
  101.                archive instead of /dev/rmt?. If the name of the
  102.                file is `-', tar writes to standard output or
  103.                reads from standard input, whichever is appropri-
  104.                ate. Thus, _t_a_r can be used as the head or tail of
  105.                a filter chain.  _T_a_r can also be used to move
  106.                hierarchies with the command
  107.                  cd fromdir; tar cf - . | (cd todir; tar xf -)
  108.  
  109.      bb         _T_a_r uses the next argument as the blocking factor
  110.                for tape records. The default is 20 (the maximum).
  111.                This option should only be used with raw magnetic
  112.                tape archives (See ff above).  The block size is
  113.                determined automatically when reading tapes (key
  114.                letters `x' and `t').
  115.  
  116.      ss         tells tar to strip off any leading slashes from
  117.                pathnames.
  118.  
  119.      ll         tells _t_a_r to complain if it cannot resolve all of
  120.                the links to the files dumped.  If this is not
  121.                specified, no error messages are printed.
  122.  
  123.      mm         tells _t_a_r not to restore the modification times.
  124.                The modification time will be the time of extrac-
  125.                tion.
  126.  
  127.  
  128.  
  129. Sprite v1.0               May 23, 1988                          2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. TAR                       User Commands                       TAR
  137.  
  138.  
  139.  
  140.      hh         Force _t_a_r to follow symbolic links as if they were
  141.                normal files or directories.  Normally, _t_a_r does
  142.                not follow symbolic links.
  143.  
  144.      BB         Forces input and output blocking to 20 blocks per
  145.                record.  This option was added so that _t_a_r can
  146.                work across a communications channel where the
  147.                blocking may not be maintained.
  148.  
  149.      CC         If a file name is preceded by --CC, then _t_a_r will
  150.                perform a _c_h_d_i_r(2) to that file name.  This allows
  151.                multiple directories not related by a close common
  152.                parent to be archived using short relative path
  153.                names.  For example, to archive files from
  154.                /usr/include and from /etc, one might use
  155.                     tar c -C /usr include -C / etc
  156.  
  157.      Previous restrictions dealing with _t_a_r's inability to prop-
  158.      erly handle blocked archives have been lifted.
  159.  
  160. FFIILLEESS
  161.      /dev/rmt?
  162.      /tmp/tar*
  163.  
  164. SSEEEE AALLSSOO
  165.      tar(5)
  166.  
  167. DDIIAAGGNNOOSSTTIICCSS
  168.      Complaints about bad key characters and tape read/write
  169.      errors.
  170.      Complaints if enough memory is not available to hold the
  171.      link tables.
  172.  
  173. BBUUGGSS
  174.      There is no way to ask for the _n-th occurrence of a file.
  175.      Tape errors are handled ungracefully.
  176.      The uu option can be slow.
  177.      The current limit on file name length is 100 characters.
  178.      There is no way selectively to follow symbolic links.
  179.      When extracting tapes created with the rr or uu options,
  180.      directory modification times may not be set correctly.
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195. Sprite v1.0               May 23, 1988                          3
  196.  
  197.  
  198.  
  199.